Advanced Settings¶
Besides the django-modeltranslation settings, documented here this app provides the following custom settings:
WAGTAILMODELTRANSLATION_CUSTOM_SIMPLE_PANELS
¶
Default: []
(empty list)
This setting is used to add custom “simple panel” classes (all panels that contain directly a field value, like FieldPanel) that need patching but are not included by default, resulting in not being created translated versions of that panel in wagtail admin. If, for example, you’re using wagtail-embedvideos the EmbedVideoChooserPanel is not patched by default so you’d need to include the fully qualified class name like the example below. This setting must be a list of fully qualified class names as strings.
WAGTAILMODELTRANSLATION_CUSTOM_SIMPLE_PANELS = ['wagtail_embed_videos.edit_handlers.EmbedVideoChooserPanel']
WAGTAILMODELTRANSLATION_CUSTOM_COMPOSED_PANELS
¶
Default: []
(empty list)
This setting behaves as the above but should be used for panels that are composed by other panels (MultiFieldPanel or FieldRowPanel for example).
WAGTAILMODELTRANSLATION_CUSTOM_COMPOSED_PANELS = ['app_x.module_y.PanelZ']
WAGTAILMODELTRANSLATION_CUSTOM_INLINE_PANELS
¶
Default: []
(empty list)
This setting behaves as the above but should be used for panels that inherit InlinePanel.
WAGTAILMODELTRANSLATION_CUSTOM_INLINE_PANELS = ['app_x.module_y.PanelZ']
WAGTAILMODELTRANSLATION_TRANSLATE_SLUGS
¶
Default: True
This setting makes slug and url_path localized. If True, each page will have a slug and url_path per language. If a slug field is not translated it will be automatically populated when the page title of it’s language is filled.
WAGTAILMODELTRANSLATION_TRANSLATE_SLUGS = True
WAGTAILMODELTRANSLATION_LOCALE_PICKER
¶
Default: True
This setting injects a locale picker in the editor interface, so that only selected locale fields are shown.
WAGTAILMODELTRANSLATION_LOCALE_PICKER = True
WAGTAILMODELTRANSLATION_LOCALE_PICKER_DEFAULT
¶
Default: None
This setting specifies, which languages should initially be enabled on the edit pages when the locale picker is used. If not set, just the default language from MODELTRANSLATION_DEFAULT_LANGUAGE
is initially enabled.
WAGTAILMODELTRANSLATION_LOCALE_PICKER_DEFAULT = None # only default language initially enabled
WAGTAILMODELTRANSLATION_LOCALE_PICKER_DEFAULT = [ ] # all languages initially disabled
WAGTAILMODELTRANSLATION_LOCALE_PICKER_DEFAULT = [ 'en', 'de' ] # these languages initially enabled
WAGTAILMODELTRANSLATION_LOCALE_PICKER_STORE
¶
Default: False
If set to true, the language picker will restore language selection on each page. Otherwise, the default will be used
WAGTAILMODELTRANSLATION_LOCALE_PICKER_RESTORE = False # the default will be used on each page
WAGTAILMODELTRANSLATION_LOCALE_PICKER_RESTORE = True # the last used language will be used on each page